package com.blog.cmrpersonalblog.annotation;

import com.blog.cmrpersonalblog.enums.LimitType;

import java.lang.annotation.*;

/**
 * 接口限流注解
 * 
 * 使用示例:
 * @RateLimit(count = 10, time = 60) // 60秒内最多10次请求
 * @RateLimit(count = 5, time = 60, limitType = LimitType.USER) // 按用户限流
 * @RateLimit(count = 100, time = 60, limitType = LimitType.GLOBAL) // 全局限流
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RateLimit {
    
    /**
     * 限流唯一标识key
     * 默认为空，会自动生成：类名:方法名
     */
    String key() default "";
    
    /**
     * 限流时间窗口，单位秒
     * 默认60秒
     */
    int time() default 60;
    
    /**
     * 限流次数
     * 默认100次
     */
    int count() default 100;
    
    /**
     * 限流类型
     * 默认按IP限流
     */
    LimitType limitType() default LimitType.IP;
    
    /**
     * 提示消息
     * 默认为空，会使用默认提示
     */
    String message() default "";
}

